tmsINTRANET 3.6 MU3 Windows 9X/Windows NT/Windows 2000 (Amazon) 
Installation Instructions 
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1. REQUIREMENTS 

Before installing tmsINTRANET, the following requirements must be met: 

1 . No web server must be running on port 8080 at the time of installation and after. 
If you have a web server such as IIS running on port 8080, please disable it. 
You may need to also uninstall or disable automatic startup of your existing 

web server. The default installation of tmsINTRANET will install Apache Tomcat 
which includes a web server. 

2. You will need to install mySQL database first before installing tmsINTRANET. 
This tmsINTRANET installation will not install the mySQL database. Make sure that 
you do not have another copy of mysQL in the server. 

3. In order to use the Email client module in tmsINTRANET, you will need access 
to a SMTP and POP3 server. 

4. tmsINTRANET requires a Java 2 Runtime Environment, and the setup will 
install JRE 1.3 if you do not already have it. 

2. INSTALLATION 

To install tmsINTRANET and mySQL for Windows 9x/Windows NT/Windows 2000, 
please follow the following instructions: 



1. Insert the tmsINTRANET Installation CD into the CD-ROM drive. 



2. Install the mySQL database by selecting from the autorun menu of the CD, OR 
double-click on the 'setup.exe' found in the mysQL folder in the CD. 

3. Install the tmsINTRANET application by selecting from the autorun menu of 
the CD or double-click on 'Setup.exe' found in tmsINTRANET folder in the CD. 

4. After successful installation, you will find four new shortcuts on your desktop: 
MySQL Startup, Tomcat Startup, Tomcat Shutdown and tmsINTRANET. 



3. STARTING UP tmsINTRANET 

1. First, double-click on the MySQL Startup shortcut and it will start MySQL, 
and an icon (traffic lights) will appear at the system tray to the bottom right 
hand corner of your screen. Right click on the traffic lights icon, to 

select 'Start Server Standalone'. 

2. Next, double click on the Tomcat Startup short icon on your desktop to launch 
Tomcat startup screen, which is your JSP/Servlet web server. 

A successful startup of Tomcat will display the following 
message: 'tmsINTRANET started - Please do not close this window'. 

3. Next, double-click on the tmsLNfTRANET shortcut to launch your web browser to 
login into tmsINTRANET. Log in with the default Username: admin and Password: 
admin. 

4. If you choose to, you can select to view the User's Guide from the autorun menu 
of the CD. Make sure you have Acrobat Reader installed. 

5. After installation, the application is defaulted to a 2-user license access. If 
you have purchased more user license please see item No. 12 for Licensing. 



4. SHUTTING DOWN tmsINTRANET 

1 . To shutdown tmsINTRANET, first double-click on the Tomcat Shutdown shortcut 
on the desktop. 

2. Next, right-click on the traffic lights icon in your system tray and select 
'ShutDown Server Standalone' for MySQL server. 

3. If you experience any problem with the installation, please do not hesitate to 



email us at support@tmsamericas.info. Your feedback is extremely important to us. 
Thank you. 

5. UNINSTALLING tmsINTRANET 

1. First, you need to shut down the Tomcat and MySQL services. 

2. Click on the Start button located on the left of your system tray. 

3. Select Settings and then Control Panel. 

4. Click on Add/Remove Programs. 

5. From the list of programs, select the one that says tmsINTRANET. 

6. Click on the Add/Remove button to confirm. 

7. The system will then proceed to remove the necessary files. 

8. Delete the tmsINTRANET folder. 

9. Restart your computer. 

6. UNINSTALLING MySQL 

1. Go to the Control Panel and double-click on the Add / Remove program icon. 

2. Select MySQL Server and Client 4.0.14 and proceed to uninstall. 

3. To delete MySQL tmsINTRANET database, please delete the MySQL folder. 

4. Restart your computer. 

7. UNINSTALLING JRE 

1. Go to the Control Panel and double-click on the Add / Remove program icon. 

2. Select Java 2 Runtime Environment Standard Edition vl.3 and proceed to uninstall. 

3. Restart your computer. 



8. CHANGING THE WEB SERVER PORT 



1. If you would like to change the default port tmsINTRANET is running on, 
edit the file "server.xml" located in the "jakarta-tomcat\conf" folder 
under your tmsINTRANET installation folder. 

2. Locate the following section: 

<!-- Normal HTTP --> 

<Connector className="org.apache.tomcat.service.PoolTcpConnector"> 

<Parameter name="handler" 

value="org. apache. tomcat.service.http.HttpConnectionHandler"/> 

<Parameter name="port" value="8080"/> 
</Connector> 

3. Change "<Parameter name="port" value="8080"/>" to 

"<Parameter name="port" value="XXXXXX"/>" where XXXXXX is your desired 
port. 

4. Shutdown and restart tmsINTRANET (refer to steps above) 



9. CHANGING THE ROOT PATH 

By default, the root path for tmsINTRANET is "/tmsINTRANET", which means 
that it is accessed through the URL "http://host/tmsINTRANET" where host 
is the domain name of the server tmsINTRANET is running on. 
To change the root path for tmsINTRANET, please follow the following steps: 

1. Stop tmsINTRANET if it is already running 

2. Go to c:\tmsINTRANET\jakarta-tomcat\confwhere c:\tmsINTRANET is where 
you installed tmsINTRANET 

3. Edit the file server.xml with a text editor, e.g. Wordpad 

4. Locate the line containing </ContextManager> 

5. Insert the following text before that line 

<Context path=7" 

docBase="webapps/tmsINTRANET" 



crossContext="false" 
debug="0" 
reloadable="false" > 
</Context> 

where path="/" indicates the desired root path, 
e.g. 

7" represents "http://host" 

"/intranet" represents "http://host/intranet" 

6. Save the file, and start Tomcat. 



10. BACKUP AND RECOVERY 

Backup Procedure: 

1. Stop all services (mysql & tomcat). 

2. Go to C:/tmsrNTRANET/jakarta-tomcat/webapps/tmsrNTRANET/sites 
Please backup this 'sites' folder. 

3. Go to C:/tmsrNTRANET/mysql/data 

The location of mysql folder depends on the chosen location during 

installation of mysql. 

Please backup the entire 'data' folder. 

Recovery Procedure: 

1. Stop all services (mysql & tomcat). 

2. Reinstall tms INTRANET. 

3. You will need to reboot your machine. 

4. Stop both services again. 

5. Replace the files that were backed up to the original locations. 

6. Start services again (mysql followed by tomcat). 



11. tmsINTRANET ON WIN9x 



1. Right click 'Tomcat StartUp' icon on desktop. From the pop up menu, choose 
'Properties'. 

2. In the 'Properties' menu, choose 'Memory' tab. 

3. In the 'Memory', choose 'Initial Environment' under 'Conventional Memory'. Set the 
'Initial Environment' to 4096. 

4. Apply the same procedure on 'Tomcat shutdown' desktop icon. 



12. Licensing 

1. Serial Number: The default installation comes with 2-user license. To enable the 
system to recognize the correct purchased license, look for the serial number 
that is supplied together with the CD. 

2. Insert Serial Number: Login as the adminstrator into tmsINTRANET and select the 
'System Setup' from the menu on the left. Click on the Edit' button, insert the 
serial number in the 'New Serial Code' field. Save. 

3. System Key: Logout and you will be brought to the login page with the 'System Key' 
information. Copy this (whole) and request for 'Activation Code' by visiting 
http://support.tmsamericas.info. 

4. Get Activation Code: Go to http://support.tmsamericas.info and register as a 

user giving valid information. Upon login, select 'tmsINTRANET Activation' from 
the menu, insert the System Key and 'Serial Number' and click on the Activate' 
button for the the website to return the Activation Code'. 

5. Activate: Go to the login page of the your installed tmsINTRANET and paste the 
Activation Code. Click on the Activate' button enable to system to register the 
number of users requested. 



